package com.ytclub.oss.adpater;

import com.ytclub.oss.entity.FileInfo;
import org.springframework.web.multipart.MultipartFile;

import java.io.InputStream;
import java.util.List;

/**
 * oss存储服务接口
 *
 * @author: HuangQi
 * @date: Created in 22:39 2024/3/16
 * @description: oss存储服务接口
 */
public interface StorageAdapter {


    /**
     * 创建bucket桶
     *
     * @param bucketName 桶名称
     */
    public void createBucket(String bucketName);

    /**
     * 上传文件
     *
     * @param uploadFile 文件流
     * @param bucketName  桶名称
     */
    public void uploadFile(MultipartFile uploadFile, String bucketName, String objectName);

    /**
     * 列出所有桶
     *
     * @return 桶名称列表
     */
    public List<String> getAllBucket();

    /**
     * 列出当前桶及文件
     *
     * @return 桶名称列表
     */
    public List<FileInfo> getAllFile(String bucketName);

    /**
     * 下载文件
     *
     * @param bucketName 桶名称
     * @param objectName 文件名称
     * @return 文件流
     */
    public InputStream downloadFile(String bucketName, String objectName);

    /**
     * 删除桶
     *
     * @param bucketName 桶名称
     */
    public void deleteBucket(String bucketName);

    /**
     * 删除文件
     *
     * @param bucketName 桶名称
     * @param objectName 文件名称
     */
    public void deleteBucket(String bucketName, String objectName);

    /**
     * 获取文件URL
     *
     * @param bucketName 桶名称
     * @param objectName 文件名称
     * @return 文件URL
     */
    String getUrl(String bucketName, String objectName);
}
